﻿<%@ Page Title="" Language="C#" TraceEnabled="true"  MasterPageFile="~/Site.Master" AutoEventWireup="true" CodeBehind="View_PageTracing.aspx.cs" Inherits="AFCEPF.Samples.WebSamples.Concepts.View_PageTracing" %>
<asp:Content ID="Content1" ContentPlaceHolderID="HeadContent" runat="server">
</asp:Content>
<asp:Content ID="Content2" ContentPlaceHolderID="MainContent" runat="server">

<h3>Usage du Traçage</h3>

<p>
Les informations de trace sont souvent utiles pour débugger ou optimiser une page donnée,
ou encore l'intégralité d'un site ASP.NET.
<br />

</p>
    <h4>Configuration du TRACING au NIVEAU de LA PAGE.</h4>
       <p>
        On peut activer le Tracing pour une page donnée en ajoutant l'attribut <b>TraceEnabled</b>="true"
        dans la directive Page de la page (dans le fichier .ASPX).
        Les informations de tracing seront alors affichées dans la page elle-même, après son
        contenu normal, comme démontré ci-dessous :
    </p>

    <h4>Configuration du Tracing au niveau application</h4>
       <p>
        On peut activer le Tracing au niveau de l'application toute entière en définissant
        une section Trace dans le fichier <b>Web.config</b>.
        Les options disponibles pour cette section <b>Trace</b> sont les suivantes :
           <br />
    </p>
    <ul>
        <li><b>enabled</b> : boolean : active / désactive le traçage pour toutes les pages de 
            l&#39;application.</li>
        <li><b>pageOuput</b> : boolean : indique si les informations de tracing doivent apparaître 
            sur les pages elles-même ou être stockées dans la visionneuse de Trace</li>
        <li><b>locaOnly</b> : boolean : Définit si seuls les utilisateurs locaux peuvent visionner 
            les informations de trace (utile pour le debuggage). </li>
    </ul>
        
    <p>
    Pour activer le Tracing au niveau de l'application et constater l'effet des trois options 
    décrites ci-dessus, dé-commenter la section <b>Tracing</b> dans le fichier <b>Web.config</b>.
    </p>
    <p>
        <b>Trace Viewer / Visionneuse de Trace</b>
    </p>
    <p>
    Lorsque l'attribut <b>PageOutput</b> est à false, les informations de Trace n'apparaîssent plus sur les 
    pages elles-même. Elle sont alors écrites dans un fichier Trace.axd qui se trouve à la racine virtuelle
    de l'application.
    </p>
    <p>
        Après avoir activé la section <b>trace</b> dans le <b>Web.config</b>, et une 
        fois l&#39;attribut <b>PageOutput</b> défini à false, on peut alors
        <a href="trace.axd">Voir le fichier Trace.axd</a>
    </p>

 <hr />
    <h4>Quelques contrôles exemple.</h4>

     <table class="style1">
        <tr>
            <td class="style2">
                <asp:Label ID="Label1" runat="server" Text="Une TextBox basique"></asp:Label>
            </td>
            <td>
<asp:TextBox id="tb1" runat="server" />
            </td>
        </tr>
        <tr>
            <td class="style2">
                <asp:Label ID="Label2" runat="server" 
                    Text="Une TextBox avec TextMode = Password"></asp:Label>
            </td>
            <td>
<asp:TextBox id="tb2" TextMode="password" runat="server" />
            </td>
        </tr>
        <tr>
            <td class="style2">
                <asp:Label ID="Label3" runat="server" Text="Une TextBox MultiLine"></asp:Label>
            </td>
            <td>
<asp:TextBox id="tb3" TextMode="multiline" runat="server" />
            </td>
        </tr>
    </table>    
    <hr />
    <h4>Informations de Trace obtenues grâce à l'attribut TraceEnabled de la page actuelle.tuelle.</h4>
    <p><b>Note</b> :
    <br />
    On constate que, quelle que soit la valeur des attributs de la section <b>Trace</b> du 
        <b>Web.config</b>,
    la directive <b>TraceEnabled</b> définie au niveau page prend le pas sur la valeur définie dans le 
        <b>Web.config</b>.    
    </p>
    
</asp:Content>
